home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / mapl0301.zip / ANSICHAT.DOC < prev    next >
Text File  |  1993-04-13  |  10KB  |  219 lines
  1.  
  2.                              *>>>  ANSIChat  <<<*
  3.  
  4.             The Original Built-In Split Screen ANSI Chat for RBBS
  5.  
  6.                               By Dan Drinnon
  7.                                  Scott McNay
  8.  
  9.                                  Ver. 1.10
  10.  
  11.                     Copyright (c) 1992 Daniel T. Drinnon
  12.  
  13. What is ANSIChat?
  14. -----------------
  15.  
  16. ANSIChat is a accessory for RBBS-PC that adds Split Screen Sysop Chat
  17. for chatting between the sysop and a user when RBBS detects the user has
  18. ANSI Graphics enabled and the SysOp has CONFIG option 16 (CONFIG.SYS
  19. contains 'DEVICE=ANSI.SYS) set to yes.  ANSIChat is an INTERNAL or BUILT-IN
  20. ANSI Split Screen Chat and is easily installed into RBBS-PC.  ANSIChat is
  21. written for RBBS-PC version 17.4.  ANSIChat comes with source for the sysop
  22. to compile and create the separate ANSIChat Module (ANSICHAT.OBJ) and link in
  23. with the rest of the RBBS code.  All that you need are the RBBS-PC source,
  24. the ANSIChat merges, Ken Goosens' BLED utility and a QuickBasic compiler (v3.0,
  25. 4.5 or BC7.1).
  26.  
  27. Features
  28. --------
  29.  
  30. ANSIChat is fully featured to handle the SysOp Keys as in the normal Sysop's
  31. non-ANSI chat included with RBBS.  Starting a chat and ending a chat is the
  32. same as the normal Sysop's Chat.  In other words, I tried tried to make
  33. ANSIChat as "RBBSish" as possible.  Word wrap is employed and as you or the
  34. user type along, the next line is always blanked.  TAB, Backspace and ENTER
  35. are also acknowledged.
  36.  
  37. I strived to make ANSIChat as simple as possible for the main reason of
  38. not using up much RAM or BASIC DS FreeSpace (String Space) which allows for
  39. other accessories for RBBS, such as Tom Collin's ANSIEd to be incorporated as
  40. well.
  41.  
  42. Conditions
  43. ----------
  44.  
  45. ANSIChat is to be considered 'USERWARE' and is to be distributed free of
  46. charge.  I retain ALL rights to ANSIChat - the source, documentation, and
  47. merge files when the merge files are not merged against RBBS.
  48. ANSIChat and thedistributed files withing the ANSIChat archive may only be
  49. used under the following conditions:
  50.  
  51. You may modify ANSIChat any way you wish on YOUR BBS, but you may not
  52. distribute this modified ANSIChat without permission.  You may not
  53. distribute your mods to RBBS or any other BBS system with ANSIChat without
  54. my permission.  If you would like to distribute ANSIChat with your mods to
  55. RBBS or other BBS system, then you must aquire my permission first.  More
  56. than likely, I will encourage you to distribute your mods with ANSIChat,
  57. however, it is unlawful to not confer with me first.  So please have the
  58. decency to contact me first!  And always remember, "We are proud of the
  59. company that RBBS-PC keeps."
  60.  
  61. The OFFICIAL name of the ANSIChat distribution file is ACHATxxx.ZIP, where
  62. xxx denotes the version number of ANSIChat. Subsequent upgrades will only
  63. be released by me.
  64.  
  65. The Statement "The Original Built-In Split Screen ANSI Chat for RBBS" is a
  66. method to distinguish ANSIChat from any other "ANSIChat"'s for RBBS which may
  67. appear as a result of the original ANSIChat source being unlawfully infringed
  68. upon, altered and redistributed under someone else's name (i.e. STOLEN!).
  69.  
  70. ANSIChat is registered and copyrighted with the Registry of Copyrights,
  71. Library of Congress, Washington D.C.
  72.  
  73. ANSIChat is free to use by all for the following reason:  RBBS has always
  74. been the BEST BBS system, however, it is my opinion that the lack of a
  75. split screen chat may make it fall behind first place.  Therefore, with
  76. regard to those that wrote external shareware chats, this one is free,
  77. Sorry, but it's something RBBS sysops want and RBBS itself should already
  78. have!
  79.  
  80. ANSIChat has been submitted to the Authors of RBBS-PC, with permission
  81. to incorporate it into the next official version of RBBS.
  82.  
  83. The Latest version of ANSIChat will always be available on my BBS, The
  84. Cellar Door (505) 763-1795.  If you are a RBBSNet or FidoNet Sysop, you
  85. can Freq ANSIChat from 8:903/2 or 1:313/6, respectively.  The magic name
  86. of ANSICHAT will get you the latest version.  The BBS allows downloads
  87. on first call after you complete the new user registration.  Logging on
  88. and answering the New User Questionaire is Quick and Painless.
  89.  
  90.  
  91. Merging ANSIChat
  92. ----------------
  93.  
  94. The files RBBS-PC.BAS, RBBSSUB3.BAS and RBBSSUB5.BAS are the only files
  95. required to be modified.  It is beyond the scope of this documentation
  96. to tutor about how to compile RBBS-PC or how to use BLED.  If you are
  97. unfamiliar with either one - READ THE RESPECTIVE DOCS!
  98.  
  99. To Modify the RBBS-PC source, use Ken Gossens' BLED utility to merge the
  100. ANSIChat *.MRG files into the RBBS source files:
  101.  
  102. BLED /L /B RBBS-PC.BAS R-PCANSI.MRG RBBS-PC.NEW
  103. BLED /L /B RBBSSUB3.BAS RSB3ANSI.MRG RBBSSUB3.NEW
  104. BLED /L /B RBBSSUB5.BAS RSB5ANSI.MRG RBBSSUB5.NEW
  105.  
  106. Copy over your newly made RBBS-PC source files (*.NEW) to *.BAS files.
  107. Compile RBBS as you usually would along with ANSICHAT.BAS.  have the
  108. included RBBS-VAR.MOD available to your compiler or if you already have
  109. an RBBS-VAR.MOD file from other mods, then modifiy your RBBS-VAR.MOD with
  110. the changes of the ANSIChat RBBS-VAR.MOD file. Finally, Link the Object files
  111. along with ANSICHAT.OBJ as you usually would.
  112.  
  113. IF all went well, you now have a built in ANSIChat Split Screen Sysop's
  114. Chat!  Test it out - it will work in both Local and Remote modes.
  115.  
  116. IF it didn't go well - look over your changes and try again!
  117.  
  118. Sometimes running RBBS with Lots of other merges, conflicts may arise.
  119. You may have to modify RBBS-PC manually for ANSIChat to make it all work.
  120.  
  121. ANSIChat has not been found to be incompatible with any RBBS 17.4 mods or
  122. merges that I am aware of.
  123.  
  124.  
  125. Guarantees
  126. ----------
  127.  
  128. ANSIChat is fully guaranteed to work as advertised all of the time.  It
  129. is compatible with any RBBS setup and has absolutely no bugs.  If you
  130. find a problem with ANSIChat, send in your RMA number and receipt and
  131. your money will be cheerfully and expressly returned.
  132.  
  133. ANSIChat has been tested on RBBS 17.4 with no other mods.
  134. ANSIChat is distributed with the Maple Mods for RBBS as is and is compatible
  135. with all other RBBS mods therein.
  136.  
  137.  
  138. Acknowlegements
  139. ---------------
  140.  
  141. Special thanks to all those who have progressivly made RBBS the BEST. Past,
  142.  Present and Future!
  143. Special thanks to Pete Eibl of the Maple Street RBBS!
  144. Special thanks to the Friends on the Maple Developement Team for the Support
  145.  and ideas.
  146. Special thanks to Scott McNay who helped reduce the code size by nearly 40%
  147.  and constantly pointing out neat things to do.
  148. Special thanks to those who have been so receptive and use ANSIChat and wrote
  149.  me back to let me know!
  150. Special thanks to those who honor my conditions above!  You are what RBBS is
  151.  all about.
  152.  
  153.  
  154. Reaching the Author
  155. -------------------
  156.  
  157. To reach the author, enter a message in the RBBSNet RBBS-PC echomail
  158. conference or log onto the Cellar Door and leave a message there.  Paging
  159. hours are from 5:30pm - 11:30pm Mountain Time.  I can try to help you out
  160. if you have any problems.  The BBS number is at the bottom of this document.
  161.  
  162.  
  163. In The OVEN:
  164. ------------
  165.  
  166. An Internode Chat WITH ANSI Support!  No definite date of completion...still
  167. working on the recipe!  It will look like this ANSIChat.
  168.  
  169.  
  170. Revisions
  171. ---------
  172.  
  173. 1.00  -  06-28-92 Initial Release
  174. 1.01  -  06-29-92 Fix for F2 Shell to DOS from ANSICHAT
  175. 1.02  -  07-04-92 Prevent F10 from Loading another ANSIChat
  176.                   Keep ANSIChat from showing 'RBBS' if that is already
  177.                   part of the BBS name.
  178.                   added support for Sysop's PgUp/PgDn (RBBSSUB3.BAS)
  179.                   combined local and remote input routines.
  180. 1.03  -  07-09-92 Greater control over ANSI colors independent of RBBS colors
  181. 1.04  -  07-13-92 Added control to keep ANSICHAT from popping up when
  182.                   the sysop does not have ANSI installed according to
  183.                   CONFIG.
  184. 1.05  -  07-19-92 Modified RBBSSUB3 to get status of ANSIChat Capability
  185.                   in DRSTx.DEF after return from a DOOR.
  186.                   Removed redundant code in RBBS-PC.BAS.
  187.                   Included ANSIFUN - a mod to make a Ring instead of a BEEP
  188.                   for Sysop Page.
  189. 1.06  -  07-04-92 Gave the remote the option to terminate the chat by
  190.                   pressing ESC.
  191. 1.07     08-10-92 Fixed BackSpace routine to properly locate the cursor to the
  192.                   previous row when cursor is at column 1.
  193. 1.08  -  08-13-92 Fixed the wordwrap/color mix problem and tweaked the
  194.                   ANSI commands and a couple other things to speed up
  195.                   the I/O.
  196. 1.09  -  08-18-92 Changed the bottom line of the remote screen to not go
  197.                   past line 23.
  198.                   Changed ZIP distribution file name to ACHATxxx.ZIP where xxx
  199.                   denotes the version number.
  200. 1.10  -  08-26-92 Removed "STATIC" from SUB headers to force string space to
  201.                   be released after use.
  202.                   Added GetUserScreenSize sub to determine user's screen size
  203.                   so that screen layout can be determined dynamically.  Makes
  204.                   ANSIChat more compatible with non-standard (25x80) screens.
  205.                   Changed exit method to require ESC key to be pressed twice.
  206.                   This is compatible with ANSIED, and prevents accidents when
  207.                   user hits a cursor key.
  208. ---
  209.  
  210. Dan Drinnon
  211. Author of ANSIChat - The Original Built-in Split Screen ANSI Chat for RBBS
  212. The Cellar Door RBBS 9600 v32
  213. (505) 763-1795  RBBSNet 8:903/2  FidoNet 1:313/6
  214.  
  215. Scott McNay
  216. Co-Author of ANSIChat
  217. The Wizard II RBBS 9600 v32b, v42b
  218. (817) 554-5331 FidoNet 1:395/11
  219.